home *** CD-ROM | disk | FTP | other *** search
/ WOW! 2 / WOW - Vol 2.iso / pd_share / dfue / powerdos / read_me.1st < prev   
Text File  |  1994-10-16  |  12KB  |  207 lines
  1. ReadME.TXT
  2.  
  3. This is the first FreWare release of PowerDOS!
  4.  
  5. This file MUST be included with the PowerDOS.PRG.  
  6. (C)1992 DragonWare Software Inc. and (C)1992 PowerPoint Software.
  7. ALL RIGHTS RESERVED!
  8.  
  9. Place the PowerDOS.PRG in the AUTO folder.
  10. PowerDOS.PRG must be THE FIRST application run in the AUTO folder!
  11.  
  12. Place The POWERDOS folder in the Root directory of the same drive.
  13.  
  14. PowerDos is a very powerfull and compatible GEMDOS replacement.
  15.  
  16. Using PinHead:
  17. You can place PinHead in the AUTO folder before PowerDOS. This will
  18. speed up booting PowerDOS itself, but after PowerDOS is loaded,
  19. PinHead will become dormant. PowerDOS itself incorporates some of the
  20. same fast loading techniques as PinHead, and can be controlled with a
  21. variable in the CONFIGUR file in the \POWERDOS folder on the boot
  22. drive. See the variable descriptions below for further information.
  23.  
  24. FatSpeed, FolderXXX and other such fixes:
  25. These are not needed, nor will they work with PowerDOS. Nor does
  26. PowerDOS need them. The PowerDOS disk file system is much faster at
  27. dealing with disks than GemDOS with FatSpeed. And as far as problems
  28. with folder space allocation, this is a non-problem with PowerDOS as
  29. it uses self expanding data structures for virtually everything. As
  30. long as there is memory in the computer, PowerDOS will be able to open
  31. another folder, or another file.
  32.  
  33. Below is a sample CONFIGUR file with descriptions of the variables
  34. that may be set, how to set up default environment variables, and how
  35. to execute TTP programs during bootup. Warning: this information may
  36. be difficult to understand. This is why we made PDEXPERT.PRG
  37.  
  38. Note:
  39.      The CONFIGUR FILE that comes with PowerDOS is designed to work with
  40.      PDEXPERT. Do not add/Change the lines or data to the first 21 lines.
  41.  
  42.  
  43. **********          PowerDOS Configuration Variables          **********
  44.  
  45. Note: Configuration variables must start on column one of the line.
  46.       By placing an asterisk in column one (or a space, or anything),
  47.       the variable is disabled, and the default will be used instead.
  48.  
  49. ticks=50            Ticks per second, gives length of a process timeslice.
  50.                     Can be 200, 100, 50, 25 or 12. Default=50.
  51.  
  52. priority=128        Initial system priority. All processes inherit their
  53.                     parents priority. Lower numbers give lower priority,
  54.                     higher numbers give higher priority. Has little effect
  55.                     unless many processes are running. Default=128
  56.  
  57. memrsv=50           Memory to reserve at top of ram. This is used to keep
  58.                     memory hog programs from grabbing every available byte.
  59.                     The network requires small blocks of ram to be avail-
  60.                     able at all times. The next variable controls the size
  61.                     of blocks allocated within the reserve area. Size given
  62.                     as *1024 (50=51,200 bytes). Default=0, no reserve.
  63.  
  64. maxblrsv=5          Max size of blocks of ram that can be allocated within
  65.                     the reserved area. This insures that network server
  66.                     processes (which require < 5k each) can have enough
  67.                     memory to run in when all other memory is used by hogs.
  68.                     Size given as *1024 (5=5120 bytes). Default=0.
  69.  
  70. *maxtpa=4000         Maximum TPA size given to a program. When a program
  71.                     is run, it is normally given all of memory to run in.
  72.                     This memory is divided into text+data+bss+heap, with
  73.                     the first three strictly defined by the program, the
  74.                     fourth (heap) being all the rest of memory. The program
  75.                     is supposed to free what it doesn't need of the heap,
  76.                     but many don't, tying up all of memory. This variable
  77.                     can be used to control the total memory given to a
  78.                     program at startup. Size *1024. Default is no limit. 
  79.  
  80. *maxmalloc=4000      Maximum memory returned for process Malloc(-1) call.
  81.                     When most processes try to allocate more memory, they
  82.                     will do a Malloc(-1) system call, which returns the
  83.                     size of the largest block of memory. If there was a
  84.                     3 megabyte block of memory available, the call would
  85.                     return 3,000,000 and many programs would allocate the
  86.                     whole thing, thus running the system out of memory
  87.                     again. This variable sets a limit on what the OS
  88.                     returns as a result. If this was set to 2000, and
  89.                     there were 3 megs of memory in the system, the result
  90.                     of the Malloc(-1) call would be 2,000,000. Size *1024.
  91.                     Default is no limit.
  92.  
  93. *numdrives=26        Number of drive descriptors created. GemDOS will only
  94.                     recognize 16 drives, A through P, without the MetaDOS
  95.                     extension loaded. PowerDOS has no limit on the drives
  96.                     it can access. It only requires a device descriptor to
  97.                     be created for each drive. This variable lets you set
  98.                     the number of drives from 1 to 26 (setting it to 1
  99.                     would allow only drive A to be recognized). Note that
  100.                     you would still need a BIOS driver that recognized
  101.                     drives beyond P. Default is 16.
  102.  
  103. *fastload=32         Number of k of heap to clear on progam load. This is
  104.                     similar to the popular public domain program 'PinHead'
  105.                     by Charles F. Johnson. It controls the amount of memory
  106.                     to clear when a program runs. If not used (default),
  107.                     PowerDOS will clear all of the program's heap, unless
  108.                     the fastload bit is set in the programs header, in
  109.                     which case only 32k will be cleared. If a value is
  110.                     given, then that much heap will be cleared for all
  111.                     programs, and the fastload bit will be ignored.
  112.  
  113. *cache=256           Number of disk cache sectors to create. A disk cache
  114.                     will greatly increase the speed of a hard drive by
  115.                     storing commonly used sectors in ram. This cache is
  116.                     built into the PowerDOS disk file system, and testing
  117.                     shows it to be the fastest write through cache for
  118.                     the ST (a write cache, like that built into ICD
  119.                     software, is faster for many operations involving
  120.                     writes). Legal values are 50-999. Less than 50 results
  121.                     in a 50 sector cache. Default is no cache.
  122.  
  123. *auto=0              Used to control how PowerDOS handles the AUTO folder
  124.                     on bootup. Since PowerDOS is run from the AUTO
  125.                     folder itself, and replaces GemDOS, which was running
  126.                     AUTO folder programs, PowerDOS must restart the AUTO
  127.                     process itself. After it initializes itself, it runs
  128.                     programs listed in this file. It then searches the AUTO
  129.                     folder for programs, skipping all of them until it
  130.                     finds the name 'POWERDOS.PRG'. It then runs any .PRG it
  131.                     finds after that. This variable alows you to control
  132.                     this process. If this is set to 'n', then no AUTO
  133.                     programs will be run. If it is set to a number, then
  134.                     that many AUTO programs will be skipped. Setting it
  135.                     to zero means that it will run all AUTO programs.
  136.                     Default is to look for 'POWERDOS.PRG'.
  137.  
  138. *autodrv=c           Drive to continue auto folder operations from. The
  139.                     network makes it possible to have a machine with only
  140.                     a floppy disk boot with direct access to hard drives.
  141.                     It is possible, therefore, that by the time PowerDOS
  142.                     restarts the AUTO folder process, that there is a
  143.                     drive C. Normally, however, PowerDOS would look for the
  144.                     AUTO folder on whatever drive it was booted from. This
  145.                     variable allows you to force PowerDOS to look in a
  146.                     different drive for the AUTO forlder. It could even
  147.                     be used to force bootup to continue on another drive
  148.                     completely, like D or E (many programs might fail,
  149.                     though, as they expact to run form A or C). Default
  150.                     is whatever drive PowerDOS boots from.
  151.  
  152. *biosforce=y         Force the use of standard handles from the BIOS. One
  153.                     of the things a network provides is the ability to use
  154.                     the devices of another machine over the network, like
  155.                     a printer. The easiest way to do this is to redirect
  156.                     standard handle number 3 (PRN) to the printer desired.
  157.                     Any printer output using the function call Cprnout will
  158.                     then go to the printer over the network. However, some
  159.                     programs call the BIOS directly for printer support,
  160.                     and so could not be redirected. This variable, when set
  161.                     to 'y', will cause these BIOS calls to be re-issued as
  162.                     regular DOS calls, where redirection can be performed.
  163.                     Legal values are 'y'(es) or 'n'(o). Default is 'n'.
  164.  
  165. *negforce=y          GemDOS provides the ability to bypass redirection of
  166.                     the standard handles by using a negative number. If
  167.                     a program used -3 for a handle, then output would
  168.                     go to the PRN device, regardless of whether handle
  169.                     3 had been redirected. GFA Basic is one source of
  170.                     programs that do this. This would prevent redirection
  171.                     just like using the BIOS directly. This variable, when
  172.                     set to 'y', will force these negative handles to act
  173.                     like the regular handles and perform redirection.
  174.                     Default is 'n'.
  175.  
  176.  
  177.  
  178. **********               Environment Variables               **********
  179.  
  180. Environment variables may be set from this file using 'env=' followed
  181. by typical 'variable=value' definitions. The 'env=' must start in the
  182. first column, as with the other variables. Example:
  183.  
  184. env=PATH=C:\;\AUTO\;D:\DEVPAC
  185. env=SUFF=.prg,.app,.tos,.ttp
  186.  
  187. Any number of environment variables may be defined. Note, anything after
  188. the 'env=' up to the carriage return at the end of the line is considered
  189. part of the variable, hence no comment may appear on the same line. If the
  190. variable is too long for the line, it may be continued by including the
  191. symbol '~' at the end of the line (right before the carriage return). The
  192. next 'env=' statement will then be added on. Example:
  193.  
  194. env=PATH=C:\;\AUTO\;\CPX\;\ACCS\;\MODEM\;D:\;\DEVPAC\;\WWRITER\;\RCS\;~
  195. env=\GAMES\;\DTP\;\PAINT\
  196.  
  197.  
  198. **********              How to Execute Programs              **********
  199. To have PowerDOS execute a program (before it resumes executing AUTO
  200. folder programs), simply place the name of the program (the entire path
  201. name if it does not reside in the POWERDOS folder) on a line by itself,
  202. at the end of the file with a '#' sign in the first column. If the program
  203. requires a command line, then put a single space at the end of the filename,
  204. then a '$' then the command line. Example:
  205.  
  206. #aliasdrv.ttp $c,n:\node1\c\
  207.